Interpreting CP/M Error Messages: The Status Register 


The Status Register monitors various conditions in the floppy 
disk controller (part of the circuitry of the ATR8000's hoard). 
This register is made up of 8 hits, with each individual status 
hit having its own meaning. 

When -a~. CP/M error message appears on the screen, it may he 
followed hy a number. This number refers to one or more of the 
status hits. [Although some of the status hits point out errors, 
not all do. Some simply tell which conditions in the floppy disk 
controller are active.] The Status Register chart below shows the 
individual hits (3its 0 - 7). The decimal equivalent of each hit 
is also referenced because the SWP EJOS uses decimal output for 
error messages. 

To use the following chart, first determine the type of command 
that was active when the error message occurred (whether the 
floppy disk controller was trying to seek, read, or write). Then 
cross reference this command with the decimal number that 
appeared in the error message. 

For example, ERROR 64, when the system was trying to write to a 
disk, means that there is a write protect error. This means that 
you were attempting to write to a disk that was write protected 
(for example, if an 8” disk is involved, you need to place a 
write-protect tab on it, a 5 1/4" disk needs the tab removed). 

If a number in an error message is not one of the 8 decimal 
numbers above (1, 2, 4, 8, 16, 32, 64, or 128), then it is a 
combination of two. For example, ERROR 24 means that there is a 
problem with Bit 4 (16 decimal) and with Bit 3 (8 decimal). 

More detailed explanation of the bit meanings follow the chart. 


A Summary of the Status Register 


COMMAND 

0 

STATUS BITS 

Bit ^ 

Brt 6 

*• 5 

Bit 

Bit 3 

Bit 2 

Bit J 

B.« 0 



Deem* ^2 


00 

1 


Oecvnal 2 


Seek 

NOT READY 

WRITE 

PROTECT 

HEAD 

LOADED 

SEEK 

ERROR 

CRC 

ERROR 

TRACK 0 

INOEX 

BUSY 

Read 

NOT READY 

- 

RECORD 

TYPE 

RECORD 

NOT 

FOUNO 

CRC 

ERROR 

LOST 

OATA 

OATA 

REQUEST 

BUSY 

Write 

NOT READY 

WRITE 

PROTECT 

WRITE 

FAULT 

RECORO 

NOT 

FOUNO 

CRC 

ERROR 

LOST 

DATA 

DATA 

REQUEST 

BUSY 


ROT READY indicates that the requested drive is not ready. It 
can occur if the drive door is not closed, or if you 
inadvertently try to access a drive that doesn’t exist. 











































WRITE 'PROTECT means that the write protect feature is active and 
the disk cannot be written to. To write to an 8” disk, you must 
place a foil write-protect tab on the disk. To write to a 5 1/4” 
distr, you must remove the write-protect tab from the disk. 

HEAD LOADED means that the drive head is loaded and engaged. 

RECORD TYPE. When a record is being read, this indicates the 
record—type code from the data field address mark. 1= deleted 
data. mark. 0= normal data mark. 

WRITE FAULT indicates that there is a fault in writing. 

SEEK ERROR means that the desired track was not verified. 

RECORD HOT FOUND means that the desired track, sector, or side 
was not found. 


CRC ERROR means that there was a checksum error in data in a 
sector. If this occurs with a RECORD NOT POUND or a SEEK error 
(decimal 24), then there i 3 an error in one or more ID fields. If 
it occurs alone, it indicates error in a data field. 


TRACK 0 indicates that the drive's Read/Write head is 
to Track 0. 


positioned 


LO^- DATA occurs when the computer did not respond to a data 
request in one byte time. This happens when you try to read a 
longer sector than the active program was expecting. 

INDEX means that the index mark is detected from the drive. 

DATA REQUEST is a copy of the data request output. It indicates 
that the data request is full on a read operation, or that the 
data request is empty on a write operation. 

BUSY means that a command is under execution. 



A2R8000 User Accessible Monitor Routines and Variables 


This section gives the locations and calling sequences of user accessible I/O 
routines in the ATR8000 monitor. It also describes a number of important 
monitor variables that may need to be accessed by user written programs. 

ATR8000 subroutines are accessed via a table of JUMP instructions beginning at 
memory location F000 hex. All monitor calls should be made to these entry 
points, since the actual addresses of the routines inside the ATR8000 will 
vary between different releases. Parameter passing conventions for the monitor 
fall into one of two groups. The character oriented I/O routines all pass data 
using the A and C registers while the disk routines pass parameters in a 9 
byte long disk I/O parameter block pointed to by DC. 

Storage for-the monitor stack and working variables occupies the top 256 bytes 
of memory, from FFOO to FFFF hex. Included are variables used by the monitor 
resident I/O drivers and interrupt service routines, some of which are 
described below. Programs should not attempt to write into any locations in 
this block that are not specifically mentioned below. 


ATR8000 Subroutine Entry Points 


P000 

JP 

COLD 

P003 

JP 

WARM 

E006 

JP 

CONST 

E009 

JP 

CONIN 

FOOC 

JP 

CONOUT 

POOP 

JP 

DISKIO 

P012 

JP 

LISTOUT 

F015 

JP 

LISTST 

P018 

JP 

REINIT 


ATR8000 COLD START ENTRY 
ATR8000 WARM START ENTRY 
CONSOLE INPUT STATUS TEST 
CONSOLE INPUT 
CONSOLE OUTPUT 
EXECUTE DISK OPERATION 
LIST DEVICE OUTPUT 
LIST DEVICE STATUS 
CONSOLE REINITIALIZATION 
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Function 


Parameters 


Description 


COLD 

WARM 

CONST 

CONIN 

CG'sOUT 

DISKIO 

LISTOUT 

LISTST 

REINIT 


IN: none 

OUT: does not return 


Perform cold start initialization of 
ATR8000 monitor and enter command mode. 


IN: none 

OUT: does not return 


Enter ATR8000 monitor command mode with no 
reinitialization. 


IN: none 

OUT: status in A 


IN: none 

OUT character in A 


IN: character in C 
TOUT: none 


in. 

OUT: i see chart 


IN: character in C 
OUT: none 


Test for data ready in console input FIFO 
and return .status in A. If data is 
available A=0, else A=FF hex. 

Return character from console input FIFO 
in A. If FIFO is empty then loop until 
character is input. 

Output character passed in C to tl<e 
console output device. 

Execute disk operation. See Disk I/O 
Control Block Format Chart on the 
following page. 

Output character to list device without 
checking for ready status. 


IN: none 

OUT: status in A 


List device status. A=0 if printer is 
ready. to print. 


IN: none 
OUT: none 


Reinitialize console I/O after performing 
a disk operation. 
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Disk I/O Control Block Format 


@IX 


OPCODE 


side/unit 


TRACK 


SECTOR 


POINTER L0'« r 


POINTER HIGH 


AUXILIARY VM 


AUXILIARY mGE - 


STATUS 


0 = test drive ready 
1 = read sector 

-i 2 = write sector 

j 3 = read ID mark 

——| bit 7 = side # {0 or 1} 
I bits 1 and 0 = drive # 

| {0,1,2 or 3} 

I I 

j track # for read/write 

i 

sector # for read/write 


memory buffer address for 
read/write 


varies with the command being used: 
OPCODE = 0 or 3: returns contents 
of disk select latch in AUX LOW 
and disk rotational period in 
•, AUX HIGH. 

' OPCODE =1 or 2: passes sector 
! length for read/write. 

i 

i 

Returns 1797 status register contents 
after completion of disk operation. 
Equals zero if no disk errors 
occurred. % 
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ATR8000 Memory Map 


I 

i 

Ik bytes- available for —>' 
downloading user-written | 

software, ! 

Includes printer buffer->| 

in 16k configuration. | 


Present only in 64k >| 

configuration. Used as i 

printer buffer. j 

i 

I 




MONITOR 


FREE (PROTECTED) RAM 


SYSTEM RAM 


I 


PPOO...PFPP 


FOOO...FEPP 

ECOO...EFPP 


COOO...EBFF 


0000...BPPP 
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APPEMPU a 


Appendix B: The ATR8000 Monitor 


The ATRSOOO’s monitor ROM can be accessed after the ATR8000 
terminal program is run. (This terminal program is supplied with 
CP/M.) It can also be accessed from ATARI BASIC by typing in the 
ATARI BASIC program, ATRMON.BAS, listed below. 

When the terminal program is run, the sign-on message #ATRMON 
appears on the screen. Four commands can be entered herej 



Command 


D<aaaa> 


M<aaaa> 


G<aaaa> 

B 


Table 1: Monitor Commands 
Action 


Dumps 128 bytes of memory on the screen (a 
block). <aaaa> represents the memory 
location. For example, D0 will dump the 
first 128 bytes of memory. 

Command to examine and change IDO- bytes of 
memory. 

Go to a particular location. 

Boots CP/M when a CP/M disk is in Drive 1. 


The ATR8000 monitor can be accessed from ATARI DOS or OS/A+ by 
entering and running ATRMON.BAS. The monitor commands in Table 1 
also apply to this program. 


ATRMON.BAS — An ATARI BASIC Program 

100 REM <<< ATRMON.BAS >>> 

110 REM <<< D-DUMP MEM >>> 

120 REM <<< fV EXAMINE MEM >>> 

130 REM <<< G-EXICUTE AT ADD >>> 

140 DIM X*<16> 

150 X*—“0123456789ABCDEF" ! 

160 DIM C*<1> 1 

170 DIM BUF*<256> j 

180 DIM H*<5> 

190 REM SET UP USR Z 

200 Z-ADRC •) I 

210 DATA 104,76,89,228 I 

220 FOR 1-0 TO 3 

230 READ X 

240 POKE Z+I,X 

250 NEXT I 

260 REM PRESET DCB BUFFER 
270 DCB-768 

280 CMD-770:REM "R","U",“G","S" 

290 AX1-778:REM BYTE COUNT OR LOU ADD 
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300 AX2=779:REM HIGH ADD 
310 DIR=771tREM SIO CONTROL 
315 NUM=776rREM BYTE COUNT FOR SIO 
320 IN=64*REM-INPUT TO BUFFER 
330 0UTB=128:REM OUTPUT WITH BUFFER 
340 OUT=0: REM OUTPUT WITHOUT BUFFER 
350 DATA 90,1,0,0,0,0,1,0,0,0,0,0 
360 REM "2**90,DEVICE I.D. 

370 FOR 1=0 TO 11 
380 READ X 
390 POKE DCfrK ,X 
400 NEXT I 

410 REM-SET UR BUFFER ADDRESS 
420 A=ADR<:BUFS> 

430 X=INT(A/256) 

440 POKE DCS+5.X 
450 POKE DCB+4,A-X*256 
460 INPUT H* 

462 C*=H*<1,I> 

465 H*=H*< 2,LEN<H*>) 

470 IF ASC<CS>=ASC<"D"> THEN 600 

480 IF ASC<C*>=ASC<“M“> THEN 1000 

490 IF ASC< C*>=ASC<"G") THEN 1500 

500 GOTO 460 

600 REM DUMP MEMORY 

610 GOSUB 2000 

620 GOSUB 5000 

680 POKE CMD,ASC<"R"> 

690 POKE DIR,IN 
700 POKE AX1,128 
705 POKE NUM,128 
710 GOSUB 9000 
720 N=0 
725 M=D 

730 FOR 1=0 TO 127 
740 IF N>0 THEN 760 
745 D=M+I 

747 GOSUB 4000 

748 PRINT H*; 

749 PRINT " "; 

750 N=8 

760 D=PEEK<A+I) 

770 GOSUB 4000 
780 PRINT H*<3,4>; 

790 PRINT " "j 

800 N=N—1 

801 IF N>0 THEN 820 

802 FOR F=7 TO 0 STEP -1 

803 G=PEEK<<A+I>-F> 

804 IF G<32 THEN 808 

805 IF G>121 THEN 808 

806 PRINT CHR*<G>| 

807 GOTO 809 

808 PRINT "."| 

809 NEXT F 
815 PRINT 
820 NEXT I 
830 GOTO 460 
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1000 PRINT H*> I 

1010 PRINT " 

1 r-'x 60SUB 2000 
k_j GOSUB 45QOO 
V '5 M-D 

1~40 POKE CMD,ASC<"R" > 

1050 POKE DIR,IN 
1060 POKE- AX1 , 1 
1065 POKE NUM,l 
1070 GGSUB 9000 
1080 D*PEEKCA> 

1090 GOSUB 4000 
1100 PRINT HM3,4) j 
1110 INPUT H* 

1120 IF ASCCH*>»ASC< " . * ) THEN 460 

1130 IF LSNCH*>»0 THEN 1190 

1140 GOSUB 2000 

1150 POKE A,D 

1160 POKE CMD,ASC<"W"> 

1170 POKE DIR,OUTB 
1180 GOSUB 9000 
1190 M-M+l 
1200 D=M 
1210 GOSUB 5000 
1220 GOSUB 4000 
1230 PRINT H*j 
1240 PRINT ■ 

1' ^ GOTO 1040 

1^ PRINT HS 

IV 0 GOSUB 2000 

1520 GOSUB 5000 

1530 POKE CMD,ASC("G"> 

1540 POKE DIR,OUT 
1550 GOSUB 9000 
1560 GOTO 460 

2000 IF LEN<H*><1 OR LEN<H*>>4 THEN 2099 
2010 D=0 

2020 FOR J=1 TO LENCHS) 

2030 K=ASC< HS< J,J))-ASC( " 0 " > 

2040 IF K<0 THEN 2099 
2050 IF K<10 THEN 2090 
2060 K=K-7 

2070 IF K<10 THEN 2099 
2080 IF K>15 THEN 2099 
2090 D=<D*16>+K 

2095 NEXT J 

2096 RETURN 

2099 PRINT "INVALID HEX DATA" 

2100 RETURN 

4000 FOR J-4 TO 1 STEP -1 
4010 K=D 
4P''0 D=» I NT < D/16 ) 

4^_> H*<J,J)-X*<K-<D*16>+1> 

4040 NEXT J 
4. RETURN 
50U0 Y=INTCD/256) 

5010 POKE AX2,Y 
5020 POKE AX1,D-Y*256 


5030 POKE CMD,ASC<"S") 
5040 POKE DIR,OUT 
5050 GOSUB 9000 
5060 RETURN 
9000 X=USR(Z) 

9010 RETURN 


;, t v. p 

.0 $ b 



Changing Bytes in the Monitor 


Following is a listing of global variables for the ATR8000 
monitor. Use it for location references to change monitor bytes. 


GLOBAL VARIABLES FOR ATARI ZQO ROM 


RAM EQU 


OO OO OO OO 
OOOO OO 00 
OO OO OO OO 
OO OO 00 OO 


FFtO F7A6 
FFt2 F 7A6 
FF14 F7A6 
FF16 F7A6 


KEYBUF* OEFB 
DEFB 
OEFB 
OEFB 

« 

CTCVEC: DEFW 
DEFW 
OEFW 
DEFW 


0.0.0,0 
0 . 0 . 0 . o 
0.0.0.o 
0 . 0 . 0.0 


116 BYTE CONSOLE KEYBOARD INPUT FIFO 


1 SPACE FOR 4 VECTORS FOR CTC 


FFIB F7A6 
FF!A F7A6 
FF1C F7A6 
FFIE F7A6 


1 SPACE FOR 4 EXTRA VECTORS 


. .. GLOBAL VARIABLES FOR PHYSICAL DISK HANDLER 


FF 20 





C 

C 

c 

DSKVARS 

EQU 

% 


FF20 

FF 

FF 

FF 

FF 

DRVTAB* 

DEFB 

2S3.233.233.233 

?HEAD POSITIONS FOR 4 DRIVES 

FF24 

00 

00 

00 

00 

c 


DEFB 

0.0.0.0 

1 DENSITY/TYPE/SELECT BITS FOR 4 DRIVES 

FF29 

io 

IO 

10 

10 

c 

RATES* 

DEFB 

16.16.16.16 

tSETTLING DELAYS / STEP RATES TABLE 

FF2C 

OO 




c 

UNIT* 

DEFB 

0 

1 CURRENTLY SELECTED DISK4 

FF2D 

FF 




c 

TRACK* 

DEFB 

23S 

1 TRACK POSITION OF SELECTED DRIVE 

FF2E 

DC 




c 

RWMASK* 

DEFB 

11011100B 

* CHECK READY/UPROT/RNF/CRC/OVERRUN 

FF2F 

00 




c 

INUSE* 

DEFB 

0 

1 DISKS IN-USE FLAG FOR BACKGROUND 

FF30 

00 




c 

OUTCPY* 

DEFB 

OOOOOOOOB 

* COPY OF DISK CONTROL LATCH 

FF3I 

OO 




c 

PERIOD* 

DEFB 

0 

1 DISK SPIN PERIOD 

FF32 

OA 




c 

RWMAX* 

DEFB 

10 

* MAX NUMBER OF READ/WRITE RETRIES 

FF33 

OOOO 



c 

TICKS* 

DEFW 

0 

"FREE RUNNING MILI SECOND COUNTER 


... GLOBAL VARIABLES FOR ATARI HANDLER ... 


FFTS 

F397 

C 

IDPTR: 

DEFW 

IDTAB 

IPOINTER 

TO DEVICE ID TABLE 

FF 37 

FF 

c 

STBHSKs 

DEFB 

1111111 IB 

;HARDWARE 

STATUS AND' MASK 

FF38 

OO 

C 


DEFB 

OOOOOOOOB 

1 

OR' MASK 

FF39 

02 OD OA OO 

C 

NEWLIN* 

DEFB 

2.CR.LF.0.0.0 

SPRINTER 

NEWLINE CHARACTERS 

FF?D 

00 OO 

C 






FF3F 

80 

c 

PMASKS* 

DEFB 

t00000009 

;MASK ALL 

BITS BUT BUSY * 

FF 40 

OO 

c 

c 

• 

t 

DEFB 

00000000 

1COMPARE 

TO ZERO FOR READY 

0041 


c 

c 

1 

GLBSIZE 

EQU 

4-RAM 

1 LENGTH OF GLOBAL VARIABLES 


*** ININITIALI ZED SCRATCH VARIABLES CONE AFTER HERE *** 


DKIOCB* DEFS 
GRWCMD: DEFS 
LOGSIZs DEFS 
IDBUFt DEFS 
IOPTRs DEFS 
CLOCKS* DEF’S 
I 
< 


•DISK 1/ COMMAND BLOCK 
?R/W COMMAND FROM ATARI TO DISK! 
:LOGICAL SECTOR LENGTH FOR XFER 
•.BUFFER FOR tD MARK READS 
?ATARI BLOCK INPUT POINTER 
1 ATARI BLOCk INPUT CHECKSUM TEMP 
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C 

f 

... VARIABLES FOR DISK 

FORMAT FUNCTION ... 


C 

t 




FF^F 

c 

FMTSTUF 

EOU 

t 


FF?-F 

c 

FRMPTR* 

DEFS 

2 

»POINTER ro FORMAT data table 

FF 61 

c 

Si* WPTRt 

DEF3 

2 

1POINTER TO SKEW TABLE 

FF63 

c 

FILL* 

DEFS 

2 

tEMPTY SECTOR FILL DATA 

FF 65 

c 

NTRAKS* 

DEFS 

t 

»NUMBER OF TRACKS 

FF*6 

c 

NSECTSl 

DEFS 

t 

X NUMBER OF SECTORS 

FF*7 

c 

TRKSIZ* 

DEFS 

2 

9 TRACK LENGTH IN BYTES 

0«X*A 

c 

r 

FMTLEN 

EOU 

S-FMTSTIJF 


FF69 

w 

c 

SEGNUM* 

DEFS 


X TEMP SECTOR SEQUENCE NUMBER 

FF6B 

c 

SEQPTRi 

DEFS 

2 

9 TEMP ERROR LOG TABLE POINTER 

FF60 

c 

TRKPTR* 

DEFS 

2 

9POINTER TO START OF TRACK IMAGE 


c 

1 





c 

9 





c 

« 

... INITIALIZED LOCAL 

VARIABLES FOR DISK HANDLER ... 


c 

f 




FF6F _00 

c 

CNDBYTl 

DEFB 

0 

9 COMMAND BYTE FOR RE ADS/WRITES 

FF70 00 

c 

RWTRY* 

DEFB 

0 

IREAO/WRITE RETRY COUNT 

FF71 OO 

c 

FNDTRYt 

DEFB 

0 

9SEEK RETRY COUNT 


c 

1 





c 

« 




cooo 

c 

IOBUFF 

EOU 

OCOOOH 

fATARI I/O BUFFER 

0200 

c 

LEN 

EOU 

312 



c 

9 




C20O 

c 

TRKBUF 

EQU 

IOBUFF+LEN 

9TRACK BUFFER FOR READS 


c 

1 

I 






t 

.DEPHASE 


0FD3 


I 

LAST 

EOU 

% 





END 









Global Variables f or A53BOOO 2.0 RDM 






c 









c 




• 





c 


GLOBAL 

VARIABLES 

FOR ATARI Z80 ROM .. T ,....... * 





c 




♦ 





c 

; 








c 

i 








c 

l 








c 

l 




FFOO 




c 

r 

RAM 

EQU 

% 


FFOO 

00 00 

00 

00 

c 

KEYBUF: 

DEFB 

0,0,0,0 

lib BYTE CONSOLE KEYBOARD 

FF04 

00 00 

00 

00 

c 


DEFB 

0,0,0,0 


proa 

00 00 

00 

«:>o 

c 


DEFB 

0,0,0,0 


FFOC 

OO 00 

00 

oo 

c 


DEFB 

0,0,0,0 






c 

X 




FF10 

F5F9 



c 

CTCVEC: 

DEFU 

RETI 

;SPACE FOR 4 VECTORS FOR ( 

FF12 

F5F9 



c 


DEFU 

RETI 


FF 14 

F5F9 



c 


DEFU 

RETI 


FF 16 

F5F9 



c 

Q 


DEFU 

PETI 


FF 18 

F3F9 



c 


DEFU 

RETI 

;SPACE FOR 4 EXTRA VECTOR* 

FFIA 

F5F9 



c 


DEFU 

RETI 


FF iC 

F5F9 



c 


DEFU 

PETI 


FF IE 

F5F 9 



c 


DEFU 

RETI 



c 

c 

c 

c 

c 





C 




FF20 

FF FF 

FF FF 

c 

DRVTABi 

DEFB 

255,253,255 

FF24 

00 oo 

00 00 

c 


DEFB 

0,0,0,0 

FF2B 

10 10 

10 10 

c 

RATES: 

DEFB 

16,16,16,16 

FF2C 

00 


c 

UNIT: 

DEFB 

0 

FF2D 

FF 


c 

TRACK: 

DEFB 

255 

FFZE 

Ot 


c 

OPVOFF: 

DEFB 

1 

FF IF 

00 


c 

OUTCRY: 

DEFB 

000000009 

FF30 

0000 


c 

PERIOD: 

DEFU 

0 

FF32 

32 


c 

HLDTIM: 

DEFB 

50 

FF 33 

OA 


c 

RUM AX : 

DEFB 

10 

FF34 

OO 00 

OO oo 

c 


DEFB 

0,0,0,0 




c 

? 




... GLOBAL variables for physical disk handler ... 


IHEAD POSITIONS FOR 4 DRIVES 
;DENSITY/TYPE/SELECT BITS FOR 4 DRIVES 
;SETTLING DELAYS / STEP RATES TABLE 
;CURRENTLY SELECTED DISK® 

ITRACK POSITION OF SELECTED DRIVE 
?DRIVES-OFF FLAG FROM DISK TIMER IRQ 
;COPY OF DISK CONTROL LATCH 
?DI5K SPIN PERIOD 
;hEAD LOAD DELAY 

5max number of read/write retries 

;ROOM FOR EXPANSION 


C 

C 


GLOBAL VARIABLES FOR ATARI HANDLER 


FF2a 

F921 

C 

IDPTR: 

DEFU 

IDTAB 

FF3A 

F7BE 

C 

FSMVEC: 

DEFU 

PWRWAIT 

FF3C 

F7E1 

c 

E <TVEC: 

DEFU 

DUMMY 

FF3E 

02 OD OA 00 

c 

NEULIN: 

DEFB 

2,CR,LF,0,0 

FF42 

00 

c 




FF43 

00 00 OA 00 

c 

PSMSCi 

DEFB 

0.0,10,0 

FF47 

so 

c 

PMASKS: 

DEFB 

10000000B 

FF48 

00 

c 


DEFB 

00»I>00000B 

FF49 

FBA9 

c 

FMTPTR: 

DEFU 

FMTS 

FFaB 

C 500 

c 

P5ASE: 

DEFU 

IQBUFF+<2*LEN> 

FF4D 

OFFF 

c 

c 

PSIZE: 

DEFU 

4095 

0C4F 


c 

c 

GLBSIZE 

; 

EQU 

f-RAM 



c 

c 

0 

% 

« 

**♦ UNINITIALIZED SCRA' 

FF4F 


c 

PCQUNT: 

DEFU 

0 

FF51 


c 

PINP: 

DEFU 

0 

FF53 


c 

POUT: 

DEFU 

0 

FF55 


c 

CMDFLC: 

DEFB 

0 

FF56 


c 

OMATRIX: 


FF 56 


c 


DEFS 

16 

FF66 


c 


DEFS 

16 

FF76 


c 


DEFS 

16 

FF36 


c 


DEFS 

16 

FF96 


c 

OLDPTR: 

DEFS 

2 

FF*3 


c 

DKIQCB: 

DEFS 

16 

FF A8 


c 

OF.UCMO: 

DEFS 

1 

FFA9 


c 

LOGSIZ: 

DEFS 

*■» 

FF AB 


c 

IDBUF: 

DEFS 

a 

FFB3 


c 

IQPTR: 

DEFS 

2 

FFB5 


c 

VFLAG: 

DEFS 

X 


;POINTER TO DEVICE ID TABLE 
;POINTER FOR ATARI TASK STATE MACHINE 
;POINTER FOR EXTRA TASK PROCESSOR 
;PRINTER NEWLINE CHARACTERS 

;PRINTER STATUS FRAME 
5MASK ALL BITS BUT 'BUSY' 

;COMPARE TO ZERO FOR READY 
;POINTER TO STANDARD FORMAT TABLES 

;put print buffer after here 

;MAX BUFFER INDEX OFFSET 
5LENGTH OF GLOBAL VARIABLES 


;BYTECOUNT FOR BUFFER 
5 INPUT OFFSET 
5OUTPUT OFFSET 

;COMMAND FRAME READY FLAG FROM IRQ 


C 

C 


;DRIVE POOP TABLES 


;POINTER TO FIRST DRIVE ACCESSED 
;DI5K I/O COMMAND BLOCK 
;R/U COMMAND FROM ATARI TO 'DISKIO' 
;LOGICAL SECTOR LENGTH FOR XFER 

;buffer for id mark reads 

;ATARI BLOCK INPUT POINTER 
?VERIFY FLAG FOR DISK WRITES 


5 










FFB6 
- FFB6 
FTBB 
FFB A 
FFBC 
FFBD 
FFBE 


c ? ... variables for 

C ? 

C FMTSTUF EQU • 

C FRMPTRt DEFS 2 

C SKUPTRi DEFS 2 

C FILL: DEFS 2 

C NTRAKSs DEFS 1 

C NSECTS: DEFS 1 

C TRKSIZ: DEFS 2 


DISK FORMAT FUNCTION ... 


;POINTER TO FORMAT DATA TABLE 
5POINTER TO SKEW TABLE 
;EMPTY SECTOR FILL DATA 
;NUMBER OF TRACKS 
5NUMBER OF SECTORS 
;TRACK LENGTH IN BYTES 


XK'A 

FFCO 
FTC r 
FFC4 


FFC6 

FFC7 

FFC8 

FFCA 


CiOO 

0200 

C300 


1073 


c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 

c 


FMTLEN 

EQU 

•-FMTSTUF 

SEQNUM: 

DEFS 

2 

SEQPTR: 

DEFS 

2 

TRKFTR: 

5 

DEFS 

2 

? 

? 

•.. LOCAL VARIABLES 

CMDBYT: 

DEFB 

0 

RWTRY: 

DEFB 

0 

TICKS: 

OEFU 

0 

DRVTMR: 

; 

; 

* 

; 

DEFB 

0 

IOBUFF 

EQU 

0C100H 

LEN 

; 

EQU 

512 

TRKBUF 

? 

( 

EQU 

IOBUFF+LEN 

1 

1 

•DEPHASE 

LAST 

EQU 

END 

• 


;TEMP SECTOR SEQUENCE NUMBER. 
;TEHP ERROR LOG TABLE POINTER 
(POINTER TO START GF TRACK IMAGE 


(COMMAND BYTE FOR READS/URITES 
(READ/WRITE RETRY COUNT 
(FREE RUNNING MILISECOND COUNTER 
(DISK ACTIVITY TIMER 


(ATARI I/O BUFFER 


(TRACK BUFFER FOR READS 


FOR DISK HANDLER ... 


6 
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* SERDRV-BAS: a Serial Printer Driver for ATARI DOS and OS/A+ 


A serial printer can be connected to the RS-232 Port of the ATR3D00. J12, the 
junper option that configures this port, is factory set to support an Epson 
serial printer. If you use a different type of serial printer, consult the 
printer’s manual and Section II.6 to properly configure J12. 

Serial printer drivers for printing under CP/M are explained in the ACRSOOO 

CP/M Supplement. The following serial printer driver is for serial trinting 
under ATARI DOS or OS/A+. 

SERDKV.BAS is a dtrline printer driver. To work with this driver, your printer 
needs to use Pin 20 for hard wire handshaking. The driver is set to have no 
parity and a word length of 8 bits. You may choose a baud rate of 1200. 2400. 
4800 or -9600. 

Enter this program in ATARI BASIC, then run it before printing (if the 
computer is rebooted or reset, the program will have to be run again). When 
the program has been loaded, the message SERIAL DRIVER INSTALLED will show'on 
the screen. 

CAUTION: If a parallel printer is also used on a system where a serial printer 
is being used from the RS-232 Port, once SERDRV.EAS has been run, the 
computer will have to be rebooted or reset before printing qqn be 
done from the parallel PRINTER Port. " 0,1 


SERDRV.EAS 

50 REM «SERDRV.BAS» 

55 HEM 8 BITS,NO PARITY, 1200 BAUD 
100 HEM «SERIAL PRINTER DRI7ER» 

110 DIM BUF$(256) 

120 Z=ADR(" "):HEM TYPE 4 SPACES 

130 DATA 104,76,89,228 

140 FOR 1=0 TO 3 

150 READ X 

160 POKE Z+I,X 

170 NEXT I 

180 DCB=768 

190 DATA 90,1,83,0,0,0,1,0,6,0,18,240 

200 FOR 1=0 TO 11 

210 READ X 

220 POKE DCBfI,X 

230 NEXT I 

240 X=USR(Z) 

250 A=ADR(BUF$) 

260 X=INT(A/256) 

270 POKE DCB+5,X 

280 POKE DCB+-4,A-X*256 

290 DATA 195,0,239,195,25,239 

300 FOR 1=0 TO 5 

310 READ X 

320 POKE A+I,X 

330 NEXT I 



340 POES DCB+2,A3C("W") 

350 POKE DCB+3,128 
360 POrZ DCB+10,6 
370 X=USR(2) 

380 POKE DCB+2,A3C("S") 

390 POKE DCB+3,0 
400 POKE DC3+10,0 
410 POKE DCB+11,239 
420 Xs T JSR(Z) 

430 G0SU3 2000 

440 POKE DCB<-2,ASC("W") 

450 POKE DC3+3,128 

460 POKE DCEf 8,31 

461 REM NUMBER OF PROGRAM BYTES 
470 POKE DCB+10,31 

480 X=U3R(Z) 

490 FRINT "SERIAL DRIVER INSTALLED" 
500 END 

2000 BATA 243,6,9,175,205,16,239 

2001 DATA 55,121,205,16,239,16 

2002 DATA 251,251,201,211,81,31 

2003 DATA 22,200,21,32,253,201 

2004 DATA 219,80,0,230,2,201 
2010 FOR 1=0 TO 30 

2020 READ X 
2030 POKE A+I,X 
2040 NEXT I 
2050 RETURN 


Baud rate is determined by the second variable in Line 2003. The above listing 
is for a baud rate of 1200. These are the possibilities: 


1200 Baud 
2400 Baud 
.4800 Baud 
.9600 Baud 


2003 DATA 22,200,21,32,253,201 
2003 DATA 22,100,21,32,253,201 
2003 BATA 22,48,21,32,253,201 
2003 DATA 22,22,21,32,253,201 






ADDENDUM: The Terminal Program 

The 40 column display window of the terminal program (Pages 59 - 
60) has been updated to include more commands for changing the 
window's display. The keyboard commands are direct commands which 
are not transmitted to the ATR8000. The other commands must be 
transmitted from the ATR8000. 

Moving the Display Window: 

From the Keyboard 

1) CTRL BACK S This toggle command switches the display 

window to show either the first 40 columns or 
the last 40 columns of the 80 column display. 
For example, if the first 40 columns show on 
the screen (Columns 0 - 39), entering CTRL 
BACK S changes the display to show the last 40 
columns (Columns 40 - 79). [A HOME code also 
moves the window to show Columns 0 - 39.] 

2) CTRL ; Moves the display window one column to the 

right. (The window will not move if this 
command is entered and the last 40 columns are 
currently displayed on the screen {Columns 40 
- 79}.) 

CTRL . Moves the display window one column to the 

left. (The window will not move if this 
command is entered and the first 40 columns 
are currently displayed on the screen {Columns 
0 - 39 }-) 

3) CTRL 3 This toggle command turns the Auto Display 

mode on and off. When the Auto Display mode is 
active, the display window moves with the 
cursor. (The default is on.) 

From the ATR8000 

1) ESC > An ESC > sequence moves the display window one 

column to the right. (The window will not move 
if this command is received and the window 
currently shows the last 40 columns {Columns 
40 - 79}.) 

ESC < An ESC < sequence moves the display window one 

column to the left. (The window will not move 
if this command is received and the screen 
currently displays the first 40 columns 
{Columns 0 - 39F-) 

An ESC Z sequence can be used to set the Auto 
Display mode to follow the cursor. For more 
information about ESC Z and the ESC Z 
variables, consult Pages 64 - 65. 


2) ESC Zn 






Interpreting CP/M Error Messages: The Status Register 


The Status Register monitors various conditions in the floppy 
disk controller (part of the circuitry of the ATRSOOO's board). 
This register is made up of 8 bits, with each individual status 
bit having its own meaning. 

When a CP/M error message appears on the screen, it may be 
followed by a number. This number refers to one or more of the 
status bits. [Although some of the status bits point out errors, 
not all do. Some simply tell which conditions in the floppy disk 
controller are active.] The Status Register chart below shows the 
individual bits (3its 0 - 7). The decimal equivalent of each bit 
is also referenced because the SUP EIOS uses decimal output for 
error messages. 

To use the following chart, first determine the type of command 
that was active when the error message occurred (whether the 
floppy disk controller was t.rying to seek, read, or write). Then 
cross reference this command with the decimal number that 
appeared in the error message. 

For example, ERROR 64, when the system was trying to write to a 
disk, means that there is a write protect error. This means that 
you were attempting to write to a disk that was write protected 
(for example, if an 8" disk is involved, you need to place a 
write—protect tab on it, a 5 1/4” disk needs the tab removed). 

If a number in an error message is not one of the 8 decimal 
numbers above (1, 2, 4, 8, 16, 32, 64, or 128 ), then it is a 
combination of two. For example, ERROR 24 means that there is a 
problem with Bit 4 (.16 decimal) and with Bit 3 (8 decimal). 

More detailed explanation of the bit meanings follow the chart. 


A Summary of the Status Register 


COMMAND 

❖ 

STATUS BITS 

Bit 7 

B.' g 

b.< 5 

Bit ^ 

CO 

5 

Bit 2 

Bit J 

B.I 0 


Decimal 

Decrai 22 

Decimal 

Decimal g 




Seek 


WRITE 

PROTECT 

HEAD 

LOADED 

SEEK 

ERROR 

CRC 

ERROR 

TRACK 0 

INOEX 

BUSY 

Read 

NOT READY 

- 

RECORD 

TYPE 

RECORD 

NOT 

FOUND 

CRC 

ERROR 

LOST 

DATA 

DATA 

REQUEST 

BUSY 

Write 

NOT READY 

WRITE 

PROTECT 

WRITE 

FAULT 

RECORD 

NOT 

FOUND 

CRC 

ERROR 

LOST 

OAT A 

DATA 

REQUEST 

BUSY 


TIOT READY indicates that the requested drive is not ready. It 
can occur if the drive door is not closed, or if you 
inadvertently try to access a drive that doesn’t exist. 





































WRITE PROTECT rae,ans that the write protect feature is active and 
the disk cannot be written to. To write to an 0" disk, you must 
place a foil write-protect tab on the disk. To write to a 5 1/4” 
disk, you must remove the write-protect tab from the disk. 

HEAi)LOADED means that the drive head is loaded and engaged. 

RECORD TYPE. When a record is being read, this indicates th 
record—type code frpra the data field address mark. 1= delete 
data mark. 0= normal data mark. 

WRITE FAULT indicates that there is a fault in writing. 

SEEK. ERROR means that the desired track was not verified. 

RECORD NOT POUND means that the desired track, sector, or side 
was not found. 

CRC ERROR means that there was a checksum error in data in a 
sector. If this occurs with a RECORD NOT FOUND or a SEEK error 
(deQjraaJL 24), then there is an error in one or more ID fields. If 

it bccu¥s alone, it indicates error in a data field., 

” ' r, a c ■: v 

TRACK 0 indicates that the drive's Read/Write head is positioned 
to Track 0. 

LOST DATA occurs when the computer did not respond to a data 
request in one byte time. This happens when you try to read a 
longer sector than the active program was expecting. 

INDEX means that the index mark is detected from the drive. 

DATA REQUEST is a copy of the,data bequest output. It indicates 
that the data request is full on a read operation, or that the 
data request is empty on a write operation. 

BUSY means that a command is under execution. 


Qj (P 



Addendum: Additions to DDSYSGEH.COM 

- ; .. w onnij.o >. 3i •. 
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DDSYSGEN now has an additional option that allows Stsre? j 'tO r 
customize the double density CP/M system tracks. Head load- 
timing, head settling time, drive step rate, parameters for the 
RS-232 Port (including baud rate, parity and word lengthr);,. 
selections necessary for connecting particular“printers to the" 
ATR8000, number of drives used and type of driv|g used are soie, 
of values that can be altered. szaio-- - 

The ATR8000 system allows the connection of a wide variety of 
peripherals. As different peripherals need different stipulations.-, 
in the system tracks, these tracks are preconfigured for a 
particular set. The following set of peripherals is the SWP 
standard: . 

: i:_ 't ~c;r- 

- single-sided, 40 track 5 1/4" drives. 

- single-sided, 77 track 8" drives. - -L" OHv 

- 16 ms-head settling time. ' - \ 

- a step rate that automatically adjusts to r the fastest"rata' 

the drive is capable of running. (This' raW'' 7 <iah3be ; 
marginal for some drives, so the symbolic patch function^ 
allows the user to set a defined rate.) ■ 4 

- a 50 ms head load delay. w 

- Ik byte block size for 5 1/4" disks. 

. — - a parallel printer. ^ 

( - RS-232 “ communications port configured for 1200 "bahd/bd^^ 

parity/7 bits/full duplex. ‘ " -Y r:CM 

If you have other peripherals, or if your peripherals do' hot meet' 
^■11 of the above standards^ the CP/M system tracks ,,must be., 
customized using the third p optfdh °of DDSYSGEN. . - ■ ; ; . 

The third option of DDSYSGEN, Generate Custom system, first reids 1 ' 
the double density CP/M tracks into memory, then allows changes 
to be made using the symbolic patch function. 

After selecting #3 from the DDSYSGEN menu, the screen will tell 
you "insert disk with SYSTEM.SWP file into drive A and press 
<RETURN>." This file contains the double density CP/M system 
tracks; it comes on the user's distribution CP/M disk. 

The screen will tell you that the computer is reading the system. 
If SYSTEM.SWP was not on the disk in Drive A when <RETURN> was 
pressed, the error message "CANNOT READ SYSTEM FILE" will show on 
the screen along with the message "press any key to return to 
main menu." Pressing any key will return the system to the 
DDSYSGEN menu. 

After SYSTEM.SWP has been read, the question "Do you wish to use 
the symbolic patch function (Y/N)?" will appear on the screen. To 
customize the system tracks, enter Y. The screen now asks for the 
location to change (locations are listed in the following 
subsections). After entering a location, the computer shows the 
default value of the location and allows a change to be entered. 


Pp £TO 1 



Symbols p^tch ; £^ct ion data entries are entered in hexadecimal. 
Binary* to ’hex, " .decimal to hex, and decimal to binary charts 
follow. Use'these charts along- with the instructions in each 
subsection to compute proper data entries for any changes made. 


Binary 

Hex 

Decimal 

Hex 

Decimal 

Hex 

Decimal 

Hex 

0000 

0 

0 

0 

50 

32 

100 

w 

0001 

1 

1 

1 

51 

33 

101 

65 

00^0 - 

2 

-v.j 2 

2 

52 

34 

102 

66 

oofi 

3 

~ 3 

3 

53 

35 

•103 ‘ 

67 

01OQ 

4 

L. 4 

4 

54 

36 

104 

68 

0101 

5 

■ ,>. '5 

5 

55 

37 

105 

69 

0110" 

6 

• . 6 

6 

. 56 

38 

105 

6A 

011 1 

7 

; 7 

7 

57 

39 

106 

6B 

1000 

8 

8 

8 ' 

58 

3A 

107 

6C 

1001 

9 

9 

9 

59 

3B 

108 

6D 

1010, v 

A 

10 

A 

60 

3C 

109 

6E 

i oiT • 

’ ^ , 

11 

B 

61 

3D 

110 

6F 

1 100 5 n > 

c. 

12 

C 

62 

3E 

■ 4 J11 

70 

i i;o;i; i 


13 

D~ 

63 

3F 

112 

71 

1110 ‘ 


.; ■■ 14' ‘ 

E 

64 

40 

: 113 

72 

mi 

F 

15 

F 

65 

41 

114 

73 



16 

10 

66 

42 

115 

74 

Decimal 

Binary 

17 

11 

67 

43 

116 

75 

0 

0000 

18 

12 

68 

44 

117 

76 

1 

0001 

19 

13 

69 

45 

118 

77 

2 

0010 

20 

14 

70 

46 

119 

78 

€> « 

001,1 

21 „ 

15 

71 

47 

120 

79 


0100 

22 

16 

72 

48 

121 

7A 

5 

0101 

23 

17 

73 

49 

122 

7B 

Jo 

0110. 

24 

18 

74 

4A 

123 

7C 

" 1 : , 

, o.i 11 ; 

25 

19 

v -. 7. 5 . . 

4B 

124 

7i> 

8 5 

1000 

26 

1 /f ~ “ 

76 

4C 

125 

7E 

9 

1001 

27 

IB 

77 

4D 

126 

7F 

10 

1010 

28 

1C 

78 

4E 

127 

80 

11 

1011 

29 

ID 

79 

4F 

128 

81 

12 

1100 

30 

IE 

80 

50 

129 

82 

13 

1101 

31 

IF 

81 

51 

130 

83 

14 

1110 

32 

20 

82 

52 

131 

84 

15 

1111 

33 

21 

83 

53 

132 

85 

16 

10000 

34 

22 

84 

54 

133 

86 

17 

10001 

35 

23 

85 

55 

134 

87 

18 

10010 

36 

24 

86 

56 

1.35 

88 

19 

10011 

37 

25 

87 

57 

136 

89 

20 

10100 

38 

26 

88 

58 

137 

8A 

21 

10101 

39 

27 

89 

59 

138 

8B 

22 

10110 

40 

28 

90 

5A 

139 

8C 

23 

10111 

41 

29 

91 

5B 

140 

8D 

24 

11000 

42 

2A 

92 

5C 

141 

8E 

25 

11001 

43 

2B 

93 

5D 

142 

8F 

26 

11010 

44 

2C 

94 

5E 

143 

90 

27 

11011 

45 

2D 

95 

5F 

144 

91 

28 

11100 

46 

2E 

96 

60 

145 

92 

29 

11101 

47 

2F 

97 

61 

146 

93 

30 

11110 

48 

30 

98 

62 

147 

94 

31 

11111 

49 

31 

99 

63 

148 

95 


Pa £r<=» ? 



1 0.*~'[Not ice 
1 + 0 °= 1 ), 


you do NOT add .'the digits ' tbge^li'e^. 
rather the left four bits mike-up the left_ di^£t, T Xt, ah^v 
the right four bits make up the right .digit, 0.] ' ■ ’ ■ • 


that 
the 


2: co ;oO" 


L x c 

-A 


m 


If you change any of these locations, be sure that 
changed for Drive A, RATEB for Drive B, and sa-on. 


RATEA is 


Head Load .Delay 


Location: 


*oco. 

HDLDSM^ 0 

. ■ O u 

0 

-.y 


Head load delay is the amount of time between selecting a new* 
drive and doing any reads or writes to the new drive. The value' 
is determined in decimal, then converted to hex. The default 
50 m^, or< 22 hex. Possible decimal values are from 1 to 255 ms. , j 


Multiple or Single Drive System 


Location: ONE' 


The value at this location determines if the system is a single 
drive or a multiple drive system. The default is for multipjla 
drives. Single drive system users need, to change this value. y * 


Value ‘ Meaning 

0 Multiple drives 

1 t Single ."drive 




L or o 




o 


Type of Drives 


These locations correspond to Drive A, 
D. Enter the appropriate ^hex value, 
following chart: 


% 


Locations: NTgKSA, NTRKSB 
NTRKSC, NTRKSD 

* v. 

Drive B, Drived and Drive 
..for each drive; using the 


Value (hex) 
23 
9P 
28 
A8 

50 

DO 

4D 

CD 


Type of Drive 


35 track, 
35 track, 
*40 track, 
40 track, 
80 track, 
80 track, 
*77 track, 
77 track, 


single-sided 5 1/4" drive 
double-sided 5 1/4" drive 
single-sided 5 1/4" drive 
double-sided 5 1/4" drive 
single-sided 5 1/4" drive 
double-sided 5 1/4" drive 
single-sided 8" drive 
double-sided 8” drive 


* The ATR8000 is preconfigured to accept these types of drives, 
so it is not necessary to enter either of these values. (It can 
distinguish between 5 1/4" and 8" drives.) 


For users with nonstandard drives: 

If your drive is not listed .above, the value can be determined by 
the following process. 

The value can be determined in decimal, then entered in hex. 



Determine the number of tracks the drive has. Then use the 
decimal to hex charts to convert this number to hex. For example, 
40 decimal equals 28 hex. Enter this value for the location. 

Double-sided drives: 

Determine the number of tracks the drive has. Now add 128 
(d'ecimal) to the track number. Convert this number to hex and 
enter it at the location. 

For example: To compute the value for a 40 track, double-sided 
drive, add 40 and 128. 168 = A8 hex, the value to be entered. 

CP/M Disk Parameter Blocks Locations: DD8IN, DD5IN 

The CP/M block size is preset to be 2k byte blocks for 8" disks 
and Ik byte blocks for 5 1/4" disks. WE DO NOT RECOMMEND CHANGING 
THE 8" BLOCK SIZE-. 

•. ■?? 

5 1/4" Users: CP/M only allows for 256 Ik blocks of disk storage. 
Double-sided 5 1/4" drives and single-sided 80 track drives 
exceed this (remember this is double density CP/M — a double 
density, double-sided 40 track drive can have up to 390 k bytes of 
storage). In order to realize all possible space, the block size 
needs to be changed to 2k blocks. 

If any double—sided 5 1/4" drives or any 80 track drives are 
connected, make the following location changes: 


Location 

Default 

Enter 

DD5IN+4 

03 

04 

DD5IN+5 

07 

OF 

DD5IN+9 

3F 

7F 

DD5IN+13 

10 

20 


♦To access the location +n, first enter the location (DD5IN), 
then press <RETURN> until the proper n value is accessed. 


RS-232 Port Configuration Locations: IBAUD, IBAFD+I 

The RS—232 Port is preconfigured to be 1200 baud, odd parity, 7 
bits and full duplex. These parameters must match the parameters 
of the peripheral interfaced to the RS-232 Port (and J12 must be 
properly configured). 

if the baud rate in IBAUD is changed, IBAUD+1 must also be 
changed. 

IBAUD: 

This location's value is ^determined by computing the values in a 
byte (8 bits). The numbers are entered in binary, then converted 








